Transferência em lote entre contas Delbank

Para transferir para várias contas Delbank, so será necessário informar os números de conta bancária.

---

URL

POST 'https://apisandbox.delbank.com.br/baas/api/v1/transfers/batch'

cURL

curl --location 'https://apisandbox.delbank.com.br/baas/api/v1/transfers/batch' \
--header 'Content-Type: application/json-patch+json' \
--header 'IdempotencyKey: 8ea756b5-897a-44a1-bd15-ba94a30ef86b' \
--header 'accept: text/plain' \
--header 'x-delbank-api-key: {{apiKey}}' \
--header 'x-delfinance-account-id: {{accountId}}' \
--data '[
	{
        "externalId": "{{guid}}",
		"amount": 1,
		"beneficiaryAccountNumber": "10138"
	},
	{
        "externalId": "{{guid}}",
		"amount": 2,
		"beneficiaryAccountNumber": "37990"
	},
	{
        "externalId": "{{guid}}",
		"amount": 3,
		"beneficiaryAccountNumber": "10073"
	},
	{
        "externalId": "{{guid}}",
		"amount": 4,
		"beneficiaryAccountNumber": "32743"
	}
]'

Headers

Nome	Descrição
x-delbank-api-key	Obrigatório. Chave de API
x-delfinance-account-id	Obrigatório. O número da conta Delfinance.
IdempotencyKey	Obrigatório. Chave de idempotência da requisição. Informe um GUID, sendo novo em cada requisição.

Corpo da Requisição

Nome	Tipo	Descrição
externalId	string	Identificação externa para reconciliação no sistema do cliente. Este valor será retornado durante a consulta de transferência (tanto via pagador quanto beneficiário). Webhook para a conta do beneficiário
amount	number	Obrigatório. Valor da transferência.
beneficiaryAccountNumber	string	Obrigatório. Número da conta do beneficiário.

[
	{
        "externalId": "555171d8-0c55-4fd5-978d-25733d3cbb68",
	"amount": 1,
	"beneficiaryAccountNumber": "10138"
	},
	{
        "externalId": "cbd675ff-ba9a-4f1e-8850-62bf6a496f38",
	"amount": 2,
	"beneficiaryAccountNumber": "37990"
	},
	{
        "externalId": "3e44cde3-fd21-4969-9954-de5d44226a88",
	"amount": 3,
	"beneficiaryAccountNumber": "10073"
	},
	{
        "externalId": "db9d5cab-8647-4bd4-a5b1-e6738b51dd2d",
	"amount": 4,
	"beneficiaryAccountNumber": "32743"
	}
]

Resposta

O status code 200 indicará sucesso na transação.

Sendo bem-sucedido, o retorno trará os seguintes campos no formato JSON:

Note

🚧 Essas informações serão retornadas após a criação da transferência e a consulta de transferência.

[
    {
        "id": "f235ad70-be15-4216-b791-eb75c86c0ad4",
        "type": {
            "id": 1,
            "name": "INTERNAL",
            "description": "Transferência interna"
        },
        "status": "DONE",
        "amount": 1.0,
        "createdAt": "2024-12-05T21:04:41.7533699Z",
        "transferAt": "2024-12-05T21:04:41.7533699Z",
        "transferredAt": "2024-12-05T21:04:41.7533699Z",
        "sender": {
            "number": "36013",
            "branch": "0001",
            "type": "CURRENT",
            "holder": {
                "document": "13245678901",
                "name": "TESTE PESSOA",
                "email": "[email protected]",
                "type": "NATURAL"
            },
            "bank": {
                "code": "0435",
                "name": "DELCRED SCD S.A.",
                "nameFantasy": "DELBANK",
                "ispbCode": "38224857"
            }
        },
        "recipient": {
            "number": "10138",
            "branch": "0001",
            "type": "CURRENT",
            "holder": {
                "document": "11468192000181",
                "name": "FIDC DELCRED",
                "email": "[email protected]",
                "type": "LEGAL"
            },
            "bank": {
                "code": "0435",
                "name": "DELCRED SCD S.A.",
                "nameFantasy": "DELBANK",
                "ispbCode": "38224857"
            }
        },
        "tags": []
    },
    {
        "id": "a406649b-c298-4cf8-8d9b-27e0f43155c0",
        "type": {
            "id": 1,
            "name": "INTERNAL",
            "description": "Transferência interna"
        },
        "status": "DONE",
        "amount": 2.0,
        "createdAt": "2024-12-05T21:04:41.8261637Z",
        "transferAt": "2024-12-05T21:04:41.8261637Z",
        "transferredAt": "2024-12-05T21:04:41.8261637Z",
        "sender": {
            "number": "36013",
            "branch": "0001",
            "type": "CURRENT",
            "holder": {
                "document": "4545454546593",
                "name": "Alves TESTE PESSOA",
                "email": "[email protected]",
                "type": "NATURAL"
            },
            "bank": {
                "code": "0435",
                "name": "DELCRED SCD S.A.",
                "nameFantasy": "DELBANK",
                "ispbCode": "38224857"
            }
        },
        "recipient": {
            "number": "37990",
            "branch": "0001",
            "type": "CURRENT",
            "holder": {
                "document": "999999921567",
                "name": "EDUARDO",
                "email": "[email protected]",
                "type": "NATURAL"
            },
            "bank": {
                "code": "0435",
                "name": "DELCRED SCD S.A.",
                "nameFantasy": "DELBANK",
                "ispbCode": "38224857"
            }
        },
        "tags": []
    },
    {
        "id": "d4257999-d350-4ee5-9a5d-52ec3d346cdc",
        "type": {
            "id": 1,
            "name": "INTERNAL",
            "description": "Transferência interna"
        },
        "status": "DONE",
        "amount": 3.0,
        "createdAt": "2024-12-05T21:04:41.8372496Z",
        "transferAt": "2024-12-05T21:04:41.8372496Z",
        "transferredAt": "2024-12-05T21:04:41.8372496Z",
        "sender": {
            "number": "36013",
            "branch": "0001",
            "type": "CURRENT",
            "holder": {
                "document": "12345678901",
                "name": "TESTE PESSOA",
                "email": "[email protected]",
                "type": "NATURAL"
            },
            "bank": {
                "code": "0435",
                "name": "DELCRED SCD S.A.",
                "nameFantasy": "DELBANK",
                "ispbCode": "38224857"
            }
        },
        "recipient": {
            "number": "10073",
            "branch": "0001",
            "type": "CURRENT",
            "holder": {
                "document": "12345678901",
                "name": "TESTE PESSOA 2",
                "email": "[email protected]",
                "type": "NATURAL"
            },
            "bank": {
                "code": "0435",
                "name": "DELCRED SCD S.A.",
                "nameFantasy": "DELBANK",
                "ispbCode": "38224857"
            }
        },
        "tags": []
    },
    {
        "id": "0e53992c-4f32-4270-ae0e-8f1b85cb8ceb",
        "type": {
            "id": 1,
            "name": "INTERNAL",
            "description": "Transferência interna"
        },
        "status": "DONE",
        "amount": 4.0,
        "createdAt": "2024-12-05T21:04:41.8464382Z",
        "transferAt": "2024-12-05T21:04:41.8464382Z",
        "transferredAt": "2024-12-05T21:04:41.8464382Z",
        "sender": {
            "number": "36013",
            "branch": "0001",
            "type": "CURRENT",
            "holder": {
                "document": "12345678901",
                "name": "TESTE PESSOA 3",
                "email": "[email protected]",
                "type": "NATURAL"
            },
            "bank": {
                "code": "0435",
                "name": "DELCRED SCD S.A.",
                "nameFantasy": "DELBANK",
                "ispbCode": "38224857"
            }
        },
        "recipient": {
            "number": "32743",
            "branch": "0001",
            "type": "CURRENT",
            "holder": {
                "document": "12345678911",
                "name": "TESTE PESSOA 4",
                "email": "[email protected]",
                "type": "NATURAL"
            },
            "bank": {
                "code": "0435",
                "name": "DELCRED SCD S.A.",
                "nameFantasy": "DELBANK",
                "ispbCode": "38224857"
            }
        },
        "tags": []
    }
]